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ABSTRACT 
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\> 

This  document  contains  the  results  of  a  modification  to  the 
Software  Portability  Study,  Delivery  Order  Number  9  to  Contract  DAHC26-D-10C . 
This  study  concentrated  on  determining  the  procedures  required  to  convert 
software  systems  written  in  COBOL  in  accordance  with  USACSC  standards 
to  a  portable  COBOL,  Florida  74.  A  further  conversion  from  the  Portable 
Standard  COBOL  (PSC)  to  a  COBOL  executable  on  the  Digital  Equipment 
Corporation  (CDEC)  PDP  11/70  minicomputer  was  studied  and  is  presented. 
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This  document  was  prepared  under  the  authority  of  USACSC  Contract 
Number  DAHC26-76-D-1004 ,  and  was  prepared  by  SAI  Comsystems  for  the  U.S. 
Army  Computer  System  Command.  This  study  reports  the  COBOL  software 
study. 
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CHAPTER  I 


OVERVIEW 


1.  1  [PRODUCTION 

The  United  States  Army  Computer  Systems  Command  (USACSC)  has  for 
many  years  been  developing  and  maintaining  software  systems  for  use 
throughout  the  army.  The  majority  of  these  software  systems  have  been 
written  in  COBOL  and  executed  on  IBM  360  systems.  Due  to  the  rapid 
advances  in  computer  hardware,  the  competitive  nature  of  tht  computer 
industry  and  federal  government  computer  procurement  practices,  it  is 
reasonable  to  expect  that  the  present  software  systems  will  be  required 
to  be  executed  on  hardware  for  which  they  were  not  developed.  With 
this  In  mind,  a  greater  emphasis  is  being  placed  on  software  transport¬ 
ability  within  the  USACSC. 

1 .  2  PORTABILITY 

1.2.1  By  definition,  software  portability  implies  the  degree  of 
executability  of  a  high-level  language  program  in  multiple  and/or 
varied  computer  environments.  That  is,  if  a  program  is  executable  in 
a  foreign  environment  from  which  it  was  developed  with  minimal  or  no 
modification,  it  is  considered  to  he  portable;  otherwise,  the  program 
is  not  portable. 

1.2.1  Program  portability  involves  many  aspects  of  data  processing. 


Briefly,  to  cite  a  few: 


Comparability  among  computer  vendors, 

Compiler  compatability  for  a  given  high-level  Language. 

Compiler  compatability  within  the  same  vendor  and,' or  aui-r  vendors. 
Compatability  of  a  given  high-level  language  as  used  in  var  -u 
computer  environments. 

Program  application. 

Determination  of  the  degree  to  which  a  program  is  or  is  not  port¬ 
able.  (That  is,  if  modification  is  required,  how  much  modifica¬ 
tion  is  too  much;  how  many  special  cases  should  he  incorporated 
into  considerations  for  portability). 

Determination  of  a  universally  executable  instruction  subset  of 
a  high-level  language. 

Program  dependency  on  the  computer  environment. 

-  Degree  of  program  interdependence  with  Job  Control  Language. 

Degree  of  programmed  system  dependent  device  specification. 
Variability  in  special  features  such  as  internal  sorts,  internal 
merges,  CALL's,  etc. 

Compatibility  between  operating  systems  within  a  vendor  (e.g. , 

IBM  DOS,  OS,  VS,  HASP,  MVT,  etc)  and  with  other  vendors  and 
their  variations. 

Compatability  in  system  dua  management  procedures  (within  a 
given  vendor  or  given  vendor  to  another  vendor. 

-  Compatability  in  the  relative  intelligence  built  into  the  original 
versus  the  recipient  environment  <fhe  atnount  of  Kfograinined 
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information  which  is  or  is  not  required  by  the  program 
depending  on  the  computer  environment). 


I  .  J  PORTA H  1 1.1  TV  STUDY 

1.  i.  1  The  USACSC  lias  tasked  SAi  Comsy stems  Corporation  as  Deliver,' 
Order  Number  9  of  Contract  DAHC26 -76-D- 1004  to  studv  t  :.«•  question  of 
portabilitv  in  the  context  of  the  command  envi rcnmen; .  The  final 
document,  Software  Portability  Study  -  Volumes  I  and  IT  was  delivered 
on  April  if),  19/7.  In  the  course  of  this  study,  the  following  items 
were  considered  in  the  form  o,  coinpar i sons-s imi 1 ar i t i es  and  dissimilar- 


•  COBOL  -  Programming  language  study. 

•  Job  Control  Language  (JCL)  study. 

•  executive  Software  Study  (as  applicable)  in  the 
domain  of  Operating  Systems  Environment. 

•  Computer  Hardware  Studv. 


This  study  was  conducted  using  CSACSC  minimum  hardware  config¬ 
uration  requirements  as  the  norm.  All  soitware  compa r i sons  are  based 
on  i urrent  versions  of  the  language,  JCL,  and  Executive  Software  as 
used  hv  USACSC.  The  vendors  considered  include:  Burroughs  3500,  C.s 
1300,  66 00  and  7bu0  Series,  Honeywell  6000  Series,  l.'nivac  llOo  Series, 
Data  Oeneral  Eclipse,  Digital  Equipment  Corp.  PDP  11,  and  Interdata  8/32 
Also  included  in  the  language  (COBOL)  study  are  USACSC  COBOL 
and  ANSI  '74  COBOL. 


The  purpose  of  tills  extension  is  to  take  I'SACAC  COBOL  and 
constrain  It  to  become  portable  so  that  tin-  portable  COBOL  is  usable 
by  the  PDP  11  -  hardware  environment. 

1.4  DOCUMENT  STRUCTURE 

Chapter  2  of  this  document  presents  the  general  .-.cope  e:  the 
study.  Chapter  3  presents  the  methodology  of  cou  ertinr  PSACSC  COBOL  to 
Portable  Standard  COBOL  (PSC)  (Ref:  Programming  Procedure?.  Mania! 

USACSC  18-1-1;  Optimal  COBOL  Subset  for  Sol tw.m  Portability 
DAAG29-77-G-0058)  as  well  as  the  PSC  to  PDP  11  COBOL  (Ret:  Optimal 
COBOL  Subset  for  Sot tw. ire  Portability  DAA029- 7 7-0-0058) ;  PDP-11  COBOL 
User's  Guide  No.  DEC-1 1-I.CUGA-B-D) .  Appendix  A  consists  of  a  heirarcay 
chart  and  the  detail  conversion  process  for  USACSC  COBOL  to  PSC.  Append i 
consists  of  a  heirarchy  chart  and  the  detail  conversion  process  for  PSC 


CHAPTER  2 


STUDY  SCOPE 


2.  1  INTRODUCTION 

This  chapter  presents  the  scope  of  the  modification  to  the  original 
Software  Portability  Study  delivery  order  and  some  general  understandings  and 
concepts  required  to  complete  the  task. 

2. 2  TASK  MODIFICATION 

Where  the  portability  study  included  many  aspects  of  the  porta¬ 
bility  question,  the  modification  concentrated  on  the  methodology  of  achiev¬ 
ing  the  conversion  of  systems  written  in  COBOL.  Specifically ,  the  conversion 
of  systems  written  in  accordance  with  USACSC  standard  to  an  intermediate 
COBOL  language  and  thence  to  a  specific  hardware  dependent  COBOL,  PDP  11,  is 
being  determined. 

2. 3  BACKGROUND 

2.3.1  The  methodology  being  evaluated  and  presented  In  this  document 
is  general  in  nature  and  applicable  to  both  manual  and  automated  modes  of 
operation.  The  stress  has,  however,  been  placed  on  an  automated  mode  of 
operation  where  problem  areas  are  noted  and  manual  intervention  is  required. 

2.3.2  hue  to  the  complexity  of  converting  COBOL  svstems  from  one 
hardware  vendor  t.»  another,  it  is  evident  that  no  automated  mode  of  conver¬ 
sion  will  l>e  so 1 1 - sul I  i clent .  Too  many  inconsistanc ies  occur  between  vendors 
imp  lemon it'd  COBOL  even  though  the  vendors  Indicate  that  the  language  imple¬ 
mented  is  In  accordance  with  an  ANSI  standard.  These  inconstancies  appear  in 


two  forms: 


•  The  entire  set  of  ANSI  COBOL  is  not  implemented. 

•  Vendor  extensions  have  been  implemented  to  fully 
utilize  the  unique  features  of  the  vendor  hardware. 

2.1,  i  As  indicated  in  the  portability  study  report,  the  strict  adher¬ 
ence  to  programm i ne  systems  as  a  minimal  subset  (i.e.,  COBOL  statements 
implemented  by  al 1  vendors)  to  achieve  portability,  too  severely  restricts 
the  programmer  in  capabiiity  and  makes  systems  thus  programmed  inefficient  on 
.11  hardware  systems  >n  which  it  is  executed.  Therefore,  although  the  portable 
COBOL  in  which  systems  are  programmed  and  maintained  may  be  a  minimal  subset, 
the  translation  from  this  language  to  any  hardware  dependent  COBOL  must  attempt 
to  transform  the  portable  subset  into  the  maximum  vendor  subset  possible  to 
obtain  maximum  efficiency.  The  trade  off  in  this  philosophy  is  that  the  great¬ 
er  the  vendor  subset  attempted,  then  the  greater  the  complexity  of  the 
t  rans lator . 

2 . A  TRANSLATOR  TRADE-OFF 

2.4.1  The  critical  point  in  this  trade-off  is  when  the  cost  of  develop¬ 
ing  the  translator  exceeds  the  expected  level  of  manual  intervention  in 
modifving  the  code  based  on  error  messages.  The  translator  defined  as  a 
-(■cult  or  this  effort  has  been  designed  with  an  attempt  to  minimize  the  trans¬ 
lator  development  cost  and  manual  intervention  and  yet  enable  the  utilization 
oi  >  maximum  target  COH-'I,  subset. 

2.4.2  ihe  scope  ol  t h i  extension  is  summarized  in  the  block  diagram 
ii  ip.uie  2.1).  The  approach  i-  in  achieve  portability  in  two  stages.  The 
lirst.  stage  will  accompli  h  i  lie  conversion  of  ILSACSC  COBOL  to  an  intermediate 
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figure  2.1  BLOCK  DIAGRAM 
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COBOL  l  anguag  o  element  -  et .  This  COBOL  set,  as  recommended  bv  1  nivi  r 
of  Florida  and  agivol  upon  bv  LS/tCSC,  Is  a  subsot  i>i  ANSI  '  1 4  < OBOL. 
Throughout  the  study,  this  intermediate  COBOL  will  be  referred  t  :-~ 
Por  tab  le  Standard  COBOL  (PDF  1  .  Also,  I’DS ,  being  the  prope  r  subset 

(everv  element  in  the  subset  Is  present  in  the  set)  e:  ANSI  '  .  . 

be  a  usable  CC>BOL  on  all  the  computers  that  support  full  ANSI  ’  * 

2.4.  !  The  second  stage  is  to  translate  PDS  to  PUP  il  Co  hi  1  (or 

othei  desired  hardware  environment).  This  conversion  has  been  at  to::.; 
keeping  in  mind  tb.  present  state  ot  the  art  tor  tin  COlVI.  av.t  i  Table 
LDP  11. 


-  s 


CHAPTER  3 


CONVERSION  PROCEDURES 


3.  1  INTRODUCTION 

The  primary  function  of  these  conversion  procedures  is  to  assist  a 
programmer  to  achieve  a  conversion  smoothly.  Given  a  definite  target  COBOL 
environment,  one  can  design  a  system  that  will  allow  a  conversion.  These 
conversion  procedures  serve  dual  purposes.  It  guides  towards  a  design  logic 
for  conversion  as  well  as  lists  many  abnormalities  that  need  to  he  resolved 
before  automatic  conversion  can  be  achieved.  This  chapter  discusses  in 
detail  the  rationale  and  procedure  for  conversion  of  COBOL  code  maintained  by 
USACSC  to  the  Portable  Standard  COBOL  (PSC)  to  PDP  11/70  COBOL.  Also 
included  is  a  discussion  of  Appendix  A  and  B. 

3.2  CONVERSION  SCOPE 

3.2.1  The  conversion  process  is  being  presented  strictly  in  terms  of 
the  COBOL  language.  The  major  consideration  in  this  process  is  in  terms  of 
those  capabilities  of  the  compilers  used  to  prepare  the  code  for  execution. 

JCL  or  Executive  Software  are  identified  only  if  a  given  function  is  not  avail 
able  in  the  target  COBOL. 

3. 3  APPENDIX  DESCRIPTION 

3.3.1  Two  appendicies  are  provided  as  part  of  this  document.  Appendix 

A  presents  the  conversion  process  for  USACSC  to  PSC  •  Appendix  B  pre 

sents  the  conversion  process  for  PSC  to  PDP  11/70  COBOL.  Each 

appendix  consists  of  a  heirarchial  chart  and  a  series  of  IPO’s  required  for 
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the  conversion  process. 

3.3.2  The  first  i  inure  In  each  appendix  is  a  heirarchial  representation 
of  all  the  statements  available  for  conversion  from  the  source  computer. 

3.3.3  The  numbering  technique  follows  the  heirarchy  convention  by 
levels ,  i . e . , 

level  1  -  n 

level  2  -  n.l;  n.  2,  ... 
level  3  -  n.1.1;  n.1.2,  ... 
level  4  -  n.l. 1.1;  n.l. 1.2,  ... 
and  so  on. 

3.3.4  After  page  1  in  each  appendix,  there  follows  .t  set  of  detailed 
input-process-output  (IPO).  On  eve  tv  page  of  this  IPO,  one  lowest  level  COHO I 
element  conversion  is  described.  All  IPO's  adhere  to  the  same  format. 

Tile  input  of  IPO  is  a  COBOL  source  (element).  The  process  part  of  IPO  uesci.bos 
the  methodology  and/or  logic  required  to  decide  the  outcome.  The  output  section 
of  IPO  describes  the  final  result  of  the  translation  process. 

3.3.5  Throughout  the  IPO's,  all  ANSI  '74  COBOL  syntax  conventions  are 
used .  The  only  liberty  taken  is  the  shading  of  an  option  of  the  input  element 
to  indicate  that  the  option  is  a  problem  area  in  conversion.  Also,  for  an 
element  with  multiple  options,  if  some  options  are  not  directly  transf errable , 
iht  ,.n( put  .cction  indicates  this  by  showing  possible  translations  as  described 
in  (Ik-  process  .section.  Also,  for  the  sake  of  completeness,  one  lowest  level 

c 1  emeu  I  wav  appeal  at  more  than  one  place  in  the  heirarchy  chart;  however,  they 
all  point  to  tin  same  detail  IPO  page. 
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3.3.6  The  usefulness  of  IPO’s  became  apparent  during  an  attempt  to 


convert  a  program  from  USACSC  COBOL  to  PSC.  The  following  is  an 

example  indicative  of  the  method  of  using  the  IPO's.  The  programmer  perform¬ 
ing  the  conversion  is  assumed  to  be  familiar  with  both  source  and  target 
COBOL  systems. 

1.  Find  the  IPO  corresponding  to  the  source  statement.  Use 
heirarchial  charts  by  division  as  a  quick  reference. 

2.  Follow  the  procedure  listed  in  the  process  section  of  the 
IPO. 

3.  If  a  warning  message  is  indicated,  several  situations  may 
have  occurred. 

a)  A  portion  of  the  source  statement  is  omitted 
from  the  output  as  it  is  not  required  in  the 
target  COBOL.  However,  the  omission  must  be 
accomplished  in  the  JCL. 

b)  A  portion  of  the  source  statement  is  omitted  - 
not  required  by  the  targeted  environment. 

3.4  RESTRICTIONS  AND  LIMITATIONS 

During  the  entire  study,  only  one  area  has  not  been  discussed.  This 
is  the  restrictions  and  limitations  of  the  compilers  for  which  these  conversions 
are  being  specified.  A  thorough  check  of  the  target  compiler  together  with 
practical  investigation  is  a  must  at  this  stage.  Some  of  these  areas  are: 
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1.  Number  of  i.O  TO':-  available  in  a  00  TO  -- 
DK.t’KNI1 1  NO  UI’ON  el  tuse. 

2-  Total  number  of  nesting  levels  available 
in  a  given  compiler, 
i.  Naming  conventions. 

4.  Reserved  word  list. 

.  Number  ol  !>  i  t  s  to  a  byte, 
b.  word  and  boundry  alignment. 

/.  Numeric  storage  formats. 

8.  '  ollat  ing  sentience. 


i .  )  SUMMARY 

Even  though  this  study  covers  all  the  aspects  of  COBOL  conversi. 
v,  tf  respect  to  L'bACSC  and  PSC  ,  this  is  by  no  means  a  'Total'  ■  t  ■ 

•onversion.  One  must  also  convert  the  data  from  the  old  environment  to  t  he 
new  environment  before  a  successful  execution  is  possible.  Also  all  the  sub¬ 
routines,  utilities  and  any  macros  must  he  converted  to  the  new  environment 
be)'  ire  program  execution.  Finally,  .1  <11.  conversion  must  also  be  aeoomp  1  i  shed . 
it  i-  also  likolv  ,1(1.  conversion  might  effect  source  code  in  the  new  environ¬ 
ment. 
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